home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat3
/
Tk
/
getuid.z
/
getuid
Wrap
Text File
|
1998-10-30
|
2KB
|
67 lines
TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333TTTTkkkk)))) TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333TTTTkkkk))))
NNNNAAAAMMMMEEEE
Tk_GetUid, Tk_Uid - convert from string to unique identifier
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
####ttttyyyyppppeeeeddddeeeeffff cccchhhhaaaarrrr ****TTTTkkkk____UUUUiiiidddd
Tk_Uid
TTTTkkkk____GGGGeeeettttUUUUiiiidddd(_s_t_r_i_n_g)
AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
char*_s_t_r_i_n_g(in)
String for which the corresponding unique identifier is desired.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
TTTTkkkk____GGGGeeeettttUUUUiiiidddd returns the unique identifier corresponding to _s_t_r_i_n_g. Unique
identifiers are similar to atoms in Lisp, and are used in Tk to speed up
comparisons and searches. A unique identifier (type Tk_Uid) is a string
pointer and may be used anywhere that a variable of type ``char *'' could
be used. However, there is guaranteed to be exactly one unique
identifier for any given string value. If TTTTkkkk____GGGGeeeettttUUUUiiiidddd is called twice,
once with string _a and once with string _b, and if _a and _b have the same
string value (strcmp(a, b) == 0), then TTTTkkkk____GGGGeeeettttUUUUiiiidddd will return exactly the
same Tk_Uid value for each call (Tk_GetUid(a) == Tk_GetUid(b)). This
means that variables of type Tk_Uid may be compared directly (x == y)
without having to call ssssttttrrrrccccmmmmpppp. In addition, the return value from
TTTTkkkk____GGGGeeeettttUUUUiiiidddd will have the same string value as its argument
(strcmp(Tk_GetUid(a), a) == 0).
KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
atom, unique identifier
PPPPaaaaggggeeee 1111